Sintesi

Aggiunge il plugin CkanSource per il download di risorse da portali CKAN tramite risoluzione dinamica UUID.

Closes #70

Cosa cambia

• toolkit/plugins/ckan.py - nuovo plugin con:
  • risoluzione tramite resource_show?id={resource_id}
  • fallback automatico a package_show se resource_show fallisce (404 o no URL)
  • protocol enforcer: http:// -> https:// sull'URL finale del file
  • retry loop su metadata e download
  • scoring risorse nel fallback (CSV > ZIP > XLSX > JSON > XML)
• toolkit/core/registry.py - entry ckan nei plugin built-in
• toolkit/raw/run.py - integrazione nel flusso run_raw con ext inference dall'URL risolto
• toolkit/plugins/__init__.py - docstring aggiornata
• docs/config-schema.md - schema aggiornato
• tests/test_ckan_plugin.py - test unitari: https forcing, fallback package_show, errore senza identificatore
• tests/test_raw_ext_inference.py - test inferenza estensione per tipo ckan
• tests/test_registry.py - verifica registrazione plugin

Verifiche

• pytest mirato: 16 passed
• Smoke reale su OpenBDAP (resource_id=33344, dataset_id=d598ebd9-...): download ok, 7.9 MB, URL https risolto correttamente

Note

La sintassi dataset.yml da usare con questo plugin:

sources:
  - name: saldi_storico
    type: ckan
    args:
      portal_url: https://bdap-opendata.mef.gov.it
      resource_id: "33344"
      dataset_id: "d598ebd9-949d-4214-bb33-cd9c1be08f15"

dataset_id e' opzionale - serve solo per il fallback a package_show.